Поделиться через

az ml service

  • Ссылка

Примечание.

Эта ссылка является частью расширения azure-cli-ml для Azure CLI (версия 2.0.28 или выше). Расширение автоматически установит первый раз, когда вы запускаете команду az ml service. Подробнее о расширениях.

Управление операционными службами.

Команды

Имя Описание Тип Состояние
az ml service delete

Удаление службы из рабочей области.

 Расширение ГА
az ml service get-access-token

Получение маркера для выдачи запросов к службе.

 Расширение ГА
az ml service get-keys

Получение ключей для выдачи запросов к службе.

 Расширение ГА
az ml service get-logs

Получение журналов для службы.

 Расширение ГА
az ml service list

Вывод списка служб в рабочей области.

 Расширение ГА
az ml service regen-key

Повторно создайте ключи для службы.

 Расширение ГА
az ml service run

Запустите службу в рабочей области.

 Расширение ГА
az ml service show

Отображение сведений о службе в рабочей области.

 Расширение ГА
az ml service update

Обновите службу в рабочей области.

 Расширение ГА

az ml service delete

Удаление службы из рабочей области.

az ml service delete --name
                     [--path]
                     [--resource-group]
                     [--subscription-id]
                     [--workspace-name]
                     [-v]

Обязательные параметры

--name -n

Имя службы для удаления.

Необязательные параметры

--path

Путь к папке проекта. По умолчанию: текущий каталог.

--resource-group -g

Группа ресурсов, соответствующая предоставленной рабочей области.

--subscription-id

Указывает идентификатор подписки.

--workspace-name -w

Имя рабочей области, содержащей службу для удаления.

-v

Флаг детализации.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az ml service get-access-token

Получение маркера для выдачи запросов к службе.

az ml service get-access-token --name
                               [--path]
                               [--resource-group]
                               [--subscription-id]
                               [--workspace-name]
                               [-v]

Обязательные параметры

--name -n

Имя службы.

Необязательные параметры

--path

Путь к папке проекта. По умолчанию: текущий каталог.

--resource-group -g

Группа ресурсов, соответствующая предоставленной рабочей области.

--subscription-id

Указывает идентификатор подписки.

--workspace-name -w

Имя рабочей области, содержащей службу для отображения.

-v

Флаг детализации.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az ml service get-keys

Получение ключей для выдачи запросов к службе.

az ml service get-keys --name
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]
                       [-v]

Обязательные параметры

--name -n

Имя службы.

Необязательные параметры

--path

Путь к папке проекта. По умолчанию: текущий каталог.

--resource-group -g

Группа ресурсов, соответствующая предоставленной рабочей области.

--subscription-id

Указывает идентификатор подписки.

--workspace-name -w

Имя рабочей области, содержащей службу для отображения.

-v

Флаг детализации.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az ml service get-logs

Получение журналов для службы.

az ml service get-logs --name
                       [--init]
                       [--num_lines]
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]
                       [-v]

Обязательные параметры

--name -n

Имя службы.

Необязательные параметры

--init -i

Получение журналов контейнера init вместо контейнера оценки.

Default value: False
--num_lines -l

Число строк журнала для возврата из хвоста (по умолчанию — 5000).

Default value: 5000
--path

Путь к папке проекта. По умолчанию: текущий каталог.

--resource-group -g

Группа ресурсов, соответствующая предоставленной рабочей области.

--subscription-id

Указывает идентификатор подписки.

--workspace-name -w

Имя рабочей области, содержащей службу для отображения.

-v

Флаг детализации.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az ml service list

Вывод списка служб в рабочей области.

az ml service list [--compute-type]
                   [--image-digest]
                   [--model-id]
                   [--model-name]
                   [--path]
                   [--property]
                   [--resource-group]
                   [--subscription-id]
                   [--tag]
                   [--workspace-name]
                   [-v]

Необязательные параметры

--compute-type -c

Если это указано, отображаются только службы с указанным типом вычислений. (Параметры : ACI, AKS).

--image-digest

Если это указано, будет отображаться только службы, имеющие указанный дайджест образа.

--model-id

При условии отображается только службы с указанным идентификатором модели.

--model-name

При условии отображается только службы с указанным именем модели.

--path

Путь к папке проекта. По умолчанию: текущий каталог.

--property

При условии отфильтруется по указанному ключу или значению (e.g. key или key=value). Можно указать несколько свойств с несколькими параметрами --property.

Default value: []
--resource-group -g

Группа ресурсов, соответствующая предоставленной рабочей области.

--subscription-id

Указывает идентификатор подписки.

--tag

При условии отфильтруется по указанному ключу или значению (e.g. key или key=value). Несколько тегов можно указать с несколькими параметрами --tag.

Default value: []
--workspace-name -w

Имя рабочей области, содержащей службы для списка.

-v

Флаг детализации.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az ml service regen-key

Повторно создайте ключи для службы.

az ml service regen-key --key
                        --name
                        [--path]
                        [--resource-group]
                        [--set-key]
                        [--subscription-id]
                        [--workspace-name]
                        [-v]

Обязательные параметры

--key -k

Какой ключ необходимо повторно создать, если указан повторное создание. Параметры: основной, вторичный.

--name -n

Имя службы.

Необязательные параметры

--path

Путь к папке проекта. По умолчанию: текущий каталог.

--resource-group -g

Группа ресурсов, соответствующая предоставленной рабочей области.

--set-key -s

Укажите значение проверки подлинности для указанного ключа.

--subscription-id

Указывает идентификатор подписки.

--workspace-name -w

Имя рабочей области, содержащей службу для отображения.

-v

Флаг детализации.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az ml service run

Запустите службу в рабочей области.

az ml service run --name
                  [--input-data]
                  [--path]
                  [--resource-group]
                  [--subscription-id]
                  [--workspace-name]
                  [-v]

Обязательные параметры

--name -n

Имя службы для оценки.

Необязательные параметры

--input-data -d

Данные, используемые для вызова веб-службы.

--path

Путь к папке проекта. По умолчанию: текущий каталог.

--resource-group -g

Группа ресурсов, соответствующая предоставленной рабочей области.

--subscription-id

Указывает идентификатор подписки.

--workspace-name -w

Имя рабочей области, содержащей службу для запуска.

-v

Флаг детализации.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az ml service show

Отображение сведений о службе в рабочей области.

az ml service show --name
                   [--path]
                   [--resource-group]
                   [--subscription-id]
                   [--workspace-name]
                   [-v]

Обязательные параметры

--name -n

Имя отображаемой веб-службы.

Необязательные параметры

--path

Путь к папке проекта. По умолчанию: текущий каталог.

--resource-group -g

Группа ресурсов, соответствующая предоставленной рабочей области.

--subscription-id

Указывает идентификатор подписки.

--workspace-name -w

Имя рабочей области, содержащей службу для отображения.

-v

Флаг детализации.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az ml service update

Обновите службу в рабочей области.

az ml service update --name
                     [--add-property]
                     [--add-tag]
                     [--ae]
                     [--ai]
                     [--ar]
                     [--as]
                     [--at]
                     [--autoscale-max-replicas]
                     [--autoscale-min-replicas]
                     [--base-image]
                     [--base-image-registry]
                     [--cc]
                     [--ccl]
                     [--cf]
                     [--collect-model-data]
                     [--compute-target]
                     [--cuda-version]
                     [--dc]
                     [--description]
                     [--dn]
                     [--ds]
                     [--ed]
                     [--eg]
                     [--entry-script]
                     [--environment-name]
                     [--environment-version]
                     [--failure-threshold]
                     [--gb]
                     [--gbl]
                     [--gc]
                     [--ic]
                     [--id]
                     [--is-migration]
                     [--kp]
                     [--ks]
                     [--lo]
                     [--max-request-wait-time]
                     [--model]
                     [--model-metadata-file]
                     [--no-wait]
                     [--nr]
                     [--path]
                     [--period-seconds]
                     [--po]
                     [--remove-tag]
                     [--replica-max-concurrent-requests]
                     [--resource-group]
                     [--rt]
                     [--sc]
                     [--scoring-timeout-ms]
                     [--sd]
                     [--se]
                     [--sk]
                     [--sp]
                     [--st]
                     [--subscription-id]
                     [--timeout-seconds]
                     [--token-auth-enabled]
                     [--workspace-name]
                     [-v]

Обязательные параметры

--name -n

Имя службы для обновления.

Необязательные параметры

--add-property

Свойство key/value для добавления (e.g. key=value). Можно указать несколько свойств с несколькими параметрами свойств --add-.

Default value: []
--add-tag

Тег ключа и значения для добавления (e.g. key=value). Несколько тегов можно указать с несколькими параметрами тегов --add-tag.

Default value: []
--ae --auth-enabled

Следует ли включить проверку подлинности ключа для этой веб-службы. По умолчанию False.

--ai --enable-app-insights

Следует ли включить AppInsights для этой веб-службы. По умолчанию False.

--ar --autoscale-refresh-seconds

Как часто автомасштабирование должно пытаться масштабировать эту веб-службу. Значение по умолчанию — 1.

--as --autoscale-enabled

Следует ли включить автоматическое масштабирование для этой веб-службы. По умолчанию значение True, если num_replicas — Нет.

--at --autoscale-target-utilization

Целевое использование (в процентах от 100) автомасштабирование должно попытаться сохранить для этой веб-службы. Значение по умолчанию — 70.

--autoscale-max-replicas --ma

Максимальное количество контейнеров, используемых при автомасштабировании этой веб-службы. Значение по умолчанию равно 10.

--autoscale-min-replicas --mi

Минимальное количество контейнеров, используемых при автомасштабировании этой веб-службы. Значение по умолчанию — 1.

--base-image --bi

Пользовательский образ, используемый в качестве базового образа. Если базовый образ не указан, базовый образ будет использоваться на основе заданного параметра среды выполнения.

--base-image-registry --ir

Реестр образов, содержащий базовый образ.

--cc --cpu-cores

Количество ядер ЦП, выделяемых для этой веб-службы. Может быть десятичным. Значение по умолчанию — 0.1.

--ccl --cpu-cores-limit

Максимальное количество ядер ЦП, которые могут использоваться веб-службой. Может быть десятичным.

--cf --conda-file

Путь к локальному файлу с определением среды conda для использования для образа.

--collect-model-data --md

Следует ли включить сбор данных модели для этой веб-службы. По умолчанию False.

--compute-target

(предварительная версия) Указывает целевой объект вычислений с расширением AzureML, установленным для размещения перенесенной виртуальной конечной точки Kubernetes и развертывания.

--cuda-version --cv

Версия CUDA для установки образов, которым требуется поддержка GPU. Образ GPU должен использоваться в службах Microsoft Azure, таких как экземпляры контейнеров Azure, вычисления машинного обучения Azure, виртуальные машины Azure и Служба Azure Kubernetes. Поддерживаемые версии: 9.0, 9.1 и 10.0. Если задано значение "enable_gpu", значение по умолчанию равно "9.1".

--dc --deploy-config-file

Путь к JSON-файлу с метаданными развертывания.

--description -d

Описание службы.

--dn --dns-name-label

Dns-имя для этой веб-службы.

--ds --extra-docker-file-steps

Путь к локальному файлу с дополнительными шагами Docker для запуска при настройке образа.

--ed --environment-directory

Каталог для среды машинного обучения Azure для развертывания. Это тот же путь к каталогу, что и в команде az ml environment scaffold.

--eg --enable-gpu

Следует ли включить поддержку GPU на изображении. Образ GPU должен использоваться в службах Microsoft Azure, таких как экземпляры контейнеров Azure, вычисления машинного обучения Azure, виртуальные машины Azure и Служба Azure Kubernetes. По умолчанию False.

--entry-script --es

Путь к локальному файлу, который содержит код для запуска службы (относительный путь от source_directory, если он указан).

--environment-name -e

Имя среды машинного обучения Azure для развертывания.

--environment-version --ev

Версия существующей среды машинного обучения Azure для развертывания.

--failure-threshold --ft

Когда модуль Pod запускается и проба активности завершается ошибкой, Kubernetes будет пытаться --failure-пороговое время, прежде чем отказаться. По умолчанию — 3. Минимальное значение равно 1.

--gb --memory-gb

Объем памяти (в ГБ) для этой веб-службы. Может быть десятичным.

--gbl --memory-gb-limit

Максимальный объем памяти (в ГБ) этой веб-службы разрешено использовать. Может быть десятичным.

--gc --gpu-cores

Количество ядер gpu, выделяемых для этой веб-службы. По умолчанию 1.

--ic --inference-config-file

Путь к JSON-файлу или YAML, содержанию конфигурации вывода.

--id --initial-delay-seconds

Количество секунд после запуска контейнера до запуска проб активности. Значение по умолчанию — 310.

--is-migration

(предварительная версия) Перенос веб-службы AKS в конечную точку и развертывание Kubernetes в Сети. По умолчанию False.

--kp --primary-key

Первичный ключ проверки подлинности, используемый для этой веб-службы.

--ks --secondary-key

Дополнительный ключ проверки подлинности, используемый для этой веб-службы.

--lo --location

Регион Azure для развертывания этой веб-службы. Если не указать, будет использоваться расположение рабочей области. Дополнительные сведения о доступных регионах можно найти здесь: https://azure.microsoft.com/en-us/global-infrastructure/services/?regions=all&p roducts=container-instances.

--max-request-wait-time --mr

Максимальное время, когда запрос останется в очереди (в миллисекундах), прежде чем возвращать ошибку 503. Значение по умолчанию — 500.

--model -m

Идентификатор развернутой модели. Можно указать несколько моделей с дополнительными аргументами -m. Сначала необходимо зарегистрировать модели.

Default value: []
--model-metadata-file -f

Путь к JSON-файлу с метаданными регистрации модели. Несколько моделей можно предоставить с помощью нескольких -f параметров.

Default value: []
--no-wait

Пометка, чтобы не ожидать асинхронных вызовов.

--nr --num-replicas

Количество контейнеров, выделяемых для этой веб-службы. Значение по умолчанию, если этот параметр не задан, автомасштабирование включается по умолчанию.

--path

Путь к папке проекта. По умолчанию: текущий каталог.

--period-seconds --ps

Частота (в секундах) выполнения пробы активности. По умолчанию — 10 секунд. Минимальное значение равно 1.

--po --port

Локальный порт, на который будет предоставляться конечная точка HTTP службы.

--remove-tag

Ключ тега для удаления. Несколько тегов можно указать с несколькими параметрами тегов --remove-tag.

Default value: []
--replica-max-concurrent-requests --rm

Количество одновременных запросов на узел, разрешающих эту веб-службу. Значение по умолчанию — 1.

--resource-group -g

Группа ресурсов, соответствующая предоставленной рабочей области.

--rt --runtime

Какая среда выполнения используется для образа. Текущие поддерживаемые среды выполнения: spark-py и python-py|python|python|slim.

--sc --ssl-cname

Имя cname, если протокол SSL включен. Применимо только при обновлении службы ACI.

--scoring-timeout-ms --tm

Время ожидания для принудительного применения вызовов оценки для этой веб-службы. По умолчанию — 60000.

--sd --source-directory

Путь к папкам, содержащим все файлы для создания образа.

--se --ssl-enabled

Следует ли включить SSL для этой веб-службы. По умолчанию False.

--sk --ssl-key-pem-file

Файл ключа, необходимый для включения SSL.

--sp --ssl-cert-pem-file

Файл сертификата, необходимый, если включен ПРОТОКОЛ SSL.

--st --success-threshold

Минимальное число последовательных успешных попыток пробы активности после сбоя, после которых проба будет считаться успешной. Значение по умолчанию — 1. Минимальное значение равно 1.

--subscription-id

Указывает идентификатор подписки.

--timeout-seconds --ts

Количество секунд, после которого время ожидания пробы активности истекает. Значение по умолчанию — 2 секунды. Минимальное значение равно 1.

--token-auth-enabled

Следует ли включить проверку подлинности маркеров для этой веб-службы. Доступно только для веб-служб AKS. По умолчанию False.

--workspace-name -w

Имя рабочей области, содержащей службу для обновления.

-v

Флаг детализации.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.